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First Edition 


Please don’t pirate this software. We all quit good jobs to follow our dream 
and start this company. As with most dreams, you need the support of those 
around you. Pirating the software is the same as robbing us of the dream. 
Would you want someone else to ruin your dream? 


No part of this manual or the accompanying software may be reproduced or 
transmitted by any means without the express written consent of TeleGrafix 
Communications, Inc. Duplication of translation of any part of this manual 
for any use, other than personal, is a violation of United States copyright law. 


TeleGrafix Communications, Inc. has made every reasonable effort to ensure 
the accuracy of the contents of this manual. However, TeleGrafix 
Communications, Inc. assumes no responsibility for the damages due to 
errors and omissions, and disclaims any implied warranty of merchantability 
or fitness for a particular purpose. 


Printed in the United States of America 


Trademark Information 


RiPscrip, RiPaint, RIPterm, the RIP to C logo, and the TeleGrafix logo are 
trademarks of TeleGrafix Communications, Inc. 


All other trademarks are the property of their respective owners. Their use 
in this guide does not constitute an attempt by TeleGrafix to claim them as 
their own, nor does TeleGrafix specifically endorse them. 
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NOTICE OF COPYRIGHT 


Any software using this product must display a banner to all users acknowledging the copyright of the Product. 
At a minimum, the phrase “Portions Copyright © 1993 TeleGrafix Communications, Inc. and Cyberstore Online 
Systems, Inc.” shail be displayed. 


NON-COMPETITIVE PRODUCTS 


This Software may only be used in products that do not compete with TeleGrafix'’s products. Written 
authorization is available from TeleGrafix for your product to énsure compliance with these terms. 


TERM 


This license is effective until terminated. You may terminate it at any time by destroying all copies of the 
Software covered by this Agreement. |t will also terminate upon conditions set forth elsewhere in this 
Agreement or if you fail to comply with any term or condition of this Agreement. You agree upon such 
termination to destroy this Software, including all copies, functionally- equivalent derivatives, and all portions 
and modifications thereof in any form. 


LIMITED WARRANTY 


THIS SOFTWARE iS PROVIDED “AS 1S", WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY, 
AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
PERFORMANCE OF THE SOFTWARE |S WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, 
YOU (NOT TELEGRAFIX) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR 
CORRECTION. 


SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE 
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND 
YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE. | 


TeleGrafix does not warrant that the functions contained in this software will meet your requirements or that 
the operation of this Software will be uninterrupted or error-free. However, TeleGrafix does warrant the 
diskette on which the Software is furnished to be free from defects in materials and workmanship under normal 
use for a period of ninety (90) days from the date of delivery to you. 


LIMITATIONS OF REMEDIES 


TeleGrafix entire liability and your exclusive remedy shall be:. 


a) The replacement of any diskette not meeting TeleGrafix “Limited Warranty” and which is returned to 
TeleGrafix , or 

b) If TeleGrafix is unable to deliver a replacement diskette which is free of defects in materials or 
workmanship, you may terminate this Agreement by returning this Software and your money will be 
refunded. rf 


IN NO EVENT WILL TELEGRAFIX BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST 
PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF 
THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED 
REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY 
CLAIM BY ANY OTHER PARTY. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF 
LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR 
EXCLUSION MAY NOT APPLY TO YOU. 


GENERAL 


You may not sublicense, assign or otherwise transfer this License or Software except as expressly provided in 
this Agreement. Any attempt to otherwise sublicense, assign, or transfer any of the rights, duties or 
obligations hereunder is expressly prohibited and will terminate this Agreement. All Agreements covering this 
Software (including but not limited to any and all updates, upgrades, and enhancements to this Software or 
any portion thereof, bearing the same registration number) shail be deemed to be counterparts of one and the 
same License Agreement instrument. 


BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS 
AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU 
FURTHER AGREE THAT IT IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT 
BETWEEN US, WHICH SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, 
AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS 
AGREEMENT. 


iv 


NOTICE OF COPYRIGHT 


Any software using this product must display a banner to all users acknowledging the copyright of the Product. 
Ata minimum, the phrase ‘Portions Copyright © 1993 TeleGrafix Communications, Inc. and Cyberstore Online 
Systems, Inc.” shall be displayed. 


NON-COMPETITIVE PRODUCTS 


This Software may only be used in products that do not compete with TeleGrafix’s products. Written 
authorization is available from TeleGrafix for your product to dnsure compliance with these terms. 


TERM 


This license is effective until terminated. You may terminate it at any time by destroying all copies of the 
Software covered by this Agreement. It will also terminate upon conditions set forth elsewhere in this 
‘Agreement or if you fail to comply with any term or condition of this Agreement. You agree upon such 
termination to destroy this Software, including all copies, functionally- equivalent derivatives, and all portions 
and modifications thereof in any form. 


LIMITED WARRANTY 


THIS SOFTWARE IS PROVIDED “AS IS", WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY, 
AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, 
YOU (NOT TELEGRAFIX) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR 
CORRECTION. 


SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE 
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND 
YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE. 


TeleGrafix does not warrant that the functions contained in this software wiil meet your requirements or that 
the operation of this Software will be uninterrupted or error-free. However, TeleGrafix does warrant the 
diskette on which the Software is furnished to be free from defects in materials and workmanship under normal 
use for a period of ninety (90) days from the date of delivery to you. 


LIMITATIONS OF REMEDIES 
TeleGrafix entire liability and your exclusive remedy shail be:. 


a) The replacement of any diskette not meeting TeleGrafix “Limited Warranty" and which is returned to 
TeleGrafix , or 

b) If TeleGrafix is unable to deliver a replacement diskette which is free of defects in materials or 
workmanship, you may terminate this Agreement by returning this Software and your money will be 
refunded. ° 


IN NO EVENT WILL TELEGRAFIX BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST 
PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF 
THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED 
REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY 
CLAIM BY ANY OTHER PARTY. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF 
LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR 
EXCLUSION MAY NOT APPLY TO YOU. 


GENERAL 


You may not sublicense, assign or otherwise transfer this License or Software except as expressly provided in 
this Agreement. Any attempt to otherwise sublicense, assign, or transfer any of the rights, duties or 
obligations hereunder is expressly prohibited and will terminate this Agreement. All Agreements covering this 
Software (including but not limited to any and all updates, upgrades, and enhancements to this Software or 
any portion thereof, bearing the same registration number) shall be deemed to be counterparts of one and the 
same License Agreement instrument. 


BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS 
AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU 
FURTHER AGREE THAT IT IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT 
BETWEEN US, WHICH SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, 
AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS 
AGREEMENT. 


iv. 


ee eee eee er ee 


OE Ss See NR SRE the ee eee ee eg ee eee ce ee adh eck Re Ae ay tc gy bee eee See le a PMG! HOE gel tg ane gw rg ne Se Se OR gO SN re Ao MF SM ge SP et NT AS AG RYN 8 he or ReR PEI nee eee ody Pat a se 


TABLE OF CONTENTS 
Trademark Information ..sssssssssssssssssssesessssesuseeseetierstsestsestusessees ii 
Software Licensing Agreement ..........-.ssscssscssecssesssesnesssseeeease aitetcatedy iii 
ST ADIG Of Ceo riternts 25 yccss steed ccs pcos ess aa taoeahs ded sees eeduanasnces oapedgusanie Vv 
TOO TRH OAUCHON sesceis ses cescscastsess cscs skath ieselssivaescesngatsceateacinstesbaaraouiadéae 1 
DL '® TinS tall Qt OI csssscss cies esvaseosecatsbascupen canes evades neat dausesssioaitesssicersie 1 
1.2 © Included With This Product ............sssssssccsssssssessssssscseeseeoes 1 
1.3 © What Does RIP2C Do? ..........ssssssssssscsssssssssssesessssssnenecnsseseoss 2 
1.4 © Examples Using RIP2C Library .0..........sssssssscssssssessesseeses 3 
2.0 © RIP2C.EXE — RiPscrip to C Conversion Utility ............ccssessse 5 
2.1 ¢ RIP2C.EXE Command Line Parameters ............ssscesees 5 
3.0 * RIP2C Library — Support Functions and Macro ......s..s..ses0000 7 
S-1.@ Qutput ROUtlnes szjcsssceccseessassaivciscstasyentqsvajnssnaexienssescselovssils 7 
BOE TIP: TNL CR sche cciactecascasnsssiuevadvesestaskeciasvaeanyyiesssceanidies 7 
SOU TIP TVET UGE ac csciaissescy kad veerasdostadedvasees astute socnsccdeteddters 8 
SOE Ip SO Ut pUt AN psssekastsscvesseieeit setsrecstanaomtataiaianscsasesteeanns 9 
FUDD: SOMALIA 2s cas casassunasdaderosd snncsasdunsud atuctesmantcrectescbecaivesaoasvesounns 10 
3.2 © Color Palette MacroS......sessssssssssssssssecsecsescecserecsnsessessessees 11 
REDD BARU x) seisseshcccsscevasecosotes tad chs tans dus deensieottedeoaiaucatasiens 11 
GREEN. PAR F(X) sciscsssisontsecsnsvoiciuninaransccccustostersevseaciessaowicaas 11 
BLUE PART Xx) ssitessassassciassisescsnenssiosaneettergvoacsntaasintaeriestecsss 11 
RGBZP ALG 8D) asestosesscsssseustecunlsetndesrsncstaty ialastaainaaaoanusean 11 
Did S HOSE S cs ccesssascissseribietsasstitenstdet cater tncsetd tenets l aid esiitd 12 
MAX POL YROINT S sss sisssstigisssasscticascssssbsterenstshcaueiegeiecls 12 
IAASK UX. seacseseuss dan inchatcinwshs id cebaunbascdStes ante anahaassdavan diana poiaeaseas 12 
MAX 2 Y atettaccussticscscttiua saci tn utecasrtueuem rain oceneceneenets 12 
Deh © INDE SEQUON CES. sssseajucess i scessstsaulaccstssyecstaccisssleaa Mana yecsion 13 
TAD VERSION x. i6s dip saesestsassessiassne acasestascanuone ds asstaleaanaastiiveigaenes 13 
FED PIO G OEP ae tcescesss eatie sa nchasredcasniescstuctanguatasiiacinint 13 
FED PTOC OM esse iceastat teteted cpcasahaltde ai antedsatinssadasiaeieaa 14 
3.5 © Base Math Routines............ssssssssccsecsscsscescsscessessssassessecssesee 15 
C Numeric Type to Meganum conversion6..............s:0000 15 
Meganum to C Numeric Type conversions..............s0000 16 
, 3.6 © RiPscrip C Function Library. savshaaadatuadisesasccuctanssesniassaseevensins 17 
3.7 © RiPscrip Text Variable C Library...........sssssssssecscesesssaees 50 
Active Text Variables ..........ssscssssssscssssssssssesseessseees 51 
Datta Variables succegesscssctsssstsontinsnceisvtensdsiveisciceseancinn 53 


Table of RiP scrip Library Functions 


RIPPUT IMAGE occas Sccttvccsstsconssndtsteretendcitas section. 39 
RIP_QUERY...scscccsssssssssssssssssees ree enn ee 46 
RIP_READ_ SCENE vesseccsccccscsccsccssccccsscccsesscececcccsecceseessesesee 47 
RIP RECTANG UB siicieetedirsracatescctrunacicdtnetvansadienias 25 
RIP_REGION_TEXT..cccscscssssssssssssssssssssssssssssssssssssssssssssssssse 37 
RIP_RESET_WINDOWS ....cccssssssssssssssssssssssssssssssssssssssssssen 19 
RIP_SET_PALETTE .ocsecsesccceseccsssssscssssssscecssvssecsiessessecceseeceees 21 
PP TED stiles ead ite ene eae Sarees st 23 
RIP_TEXT WINDOW cececccscsccsscccscsscsccsccccsccecccccescesecsecsesssne 18 
WIP TEXT NY oiccictcte trends als coves veccnien eects nee 23 
RIP_VIEWPORT ou..ccccsccscccssssssssssssssssssscsesessecesessessssssssssssssn 19 
RIP_WRITE_ICON ....csssscsssssssssssssssssssssssssssssssssnsatssssssassessen 39 
RIP_WRITE_MODE ....cssccssssssssssssssssssssssssssssssssnssssssstssssssssn 22 


Seb Tip lineleed ssessciissenisiessissiteiauin cine pniebnileiten: 7 
SEETID ANEODU COR Sec csieieciustens avcanshaciact eds cdevssalecatant Besiniest 8 
SOE Pip OUR UE 0h oases scsiceadccscschesnésenas natdaventstslarapveonstotonceceds 9 
TAP OU Cpu bss ccensiaassttasassa cients ctneskimetuagarosipinseiaveotenspnesbtuoanediatacs 10 
REDD PART Q0): ssssecessesuiissasiayestsncictanssonsstiacaevuniversoas i eoeateneene 11 
GOREN PAO) sass site eicorpiadosucisteostuni cies nenatecsaaadunsit ies 11 
BLUE PART) scscsswstisscasncnastassiinshcetuapsvateldentearetdintacccwnsatont 11 
RG B2ZP ALAS © D) sscsscassiizicaite onslsonsiassvnsscuiea esvweasevensestantosivves 11 
MAX POLY POINTS sissies fs ictaiincepeeceiatchedsaiainrtetadans 12 
WEA ses chsstgessasthetnnlcetvonteetes aeiacseneadieileninauimernaannat 12 
IEA oY oa essotena decsetishgapet seas fesasesansamsanelstavesanmete es onatasilevas 12 
TID VETSION iitactecensvsasiesnasstaviaces caieladiansah ia tensenreueenaens 13 
TAP PTOC ONE si csessstassesacstvenviedestenarassacsacsynteniadeaieacaedebatesie 13 
FID SPT OCSON wits csectesectshisinedtiicsechonsseducntandsta acnsutibaoaviaave 14 
mnlI (Convert a integer to meganum) ...........cscsssecseeee: 15 
mnL (Convert a long to meganum)..........sscssssecseseesseesees 15 
mnF (Convert a float to a meganum).........ccssscssesscsseeseens 16 
mnD (Convert a double to meganum) .............sssssssseseses 16 


mtol (Convert a meganum to an integer) ..........sssssssesues 16 


— RSI EET TT Te ay RE Pe eM Pe ae ete RES Lee Oe PIN ere aa Te ee RR ee Se See et ret Se ee, ee ee tye NTE ea OO TP SS Sa 


Chapter 1: Introduction 


1.0 - Introduction 


Thank you for purchasing the RIP2C library and conversion program. This 
product is designed to aid the developer in generating RIPscrip graphical . 
-codes easily from within C applications. 


The RIP2C software consists of two parts. First, there is a conversion utility 
called RIP2C. EXE which will take a .RIP file and convert it to C language 
function calls compatible with our RIPscrip C libraries. Second, you are also 
provided with a set of library files (in Borland C . LIB format) to link into 
your application, royalty free. The libraries allow your application to 
generate RIPscrip code quickly and easily. Simply link in the appropriate 
library for your memory model, include the associated RIP .H header file 
into your application source and you have all the RIPscrip commands at your 
fingertips to do with what you wish. 

IMPORTANT 
As stated in the Licensing Agreement, products based on these libraries may 
only be distributed in executable (compiled) form. No source code may be 
distributed, and the library files may not be distributed. If you wish to 
distribute a source code product, you must resell our RIP2C software with it. 
Contact TeleGrafix for information on becoming a reseller. 


IMPORTANT 


1.1 + Installation 


To install this software, simply insert the diskette into either of your diskette 
drives (A: or B:) and enter the following: 


A: INSTALL 
or, B: INSTALL 


You will be asked what directory you wish to install the files into and the 
Install program will do the rest for you. Quick and painless installation. 


1.2 « Included With This Product 


Included with this product, you should have received the following files on 
your distribution diskette (after installation): 


RIP2C.EXE The MS-DOS .RIP to .C conversion utility program 
RIP.H The prototype header for #include’ing 


< List continues on the next page > 
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RIP2C_BS.LIB Small Memory Model Borland C/C++ Library 
RIP2C_BT.LIB Tiny Memory Model Borland C/C++ Library 
RIP2C_BM.LIB Medium Memory Model Borland C/C++ Library 
RIP2C_BC.LIB Compact Memory Model Borland C/C++ Library 
RIP2C_BL.LIB Large Memory Model Borland C/C++ Library 
RIP2C_BH.LIB Huge Memory Model Borland C/C++ Library 


Microsoft C Libraries are available if needed. Please contact TeleGrafix at 
714/379-2131 if you need these libraries. For other compilers, you will need 
the RIP2C Source Code option, which will enable you to compile your own 
set of libraries. The RIP2C source code complies with ANSI C standards. 


1.3 - What Does RIP2C Do? 


RIP2C is a comprehensive set of every RIPscrip command in one library. 
Every feature of RIPscrip is supported in the library - meaning you can access 
every feature from your application. ‘ 


There are two distinct parts of the RIP2C product - the RIP2C conversion 
program and the set of RIPscrip “C” language libraries. The RIP2C converter 
program will take any .RIP file and convert it toa .c file with every 
RiPscrip command converted to its corresponding RIP “C” language function 
call. For example, if you had a .RIP file with a single RIPscrip command to 
draw a line, your .C file might look something like this: 


rip_line(10, 30, 200, 220); 


This makes it so that you can draw things in a RIPscrip paint program like 
RIPaint and then convert the scene directly to C code that you can link-in 
directly into your C program! 


The other side of the RIP2C product is the set of library files. These libraries, 
when used in your application program, give you the ability to generate 
RIPscrip code from within your application under program control. This 
makes things like automated graphing programs, terrain generators, 
CAD/CAM design conversion to RIPscrip a dream! What you choose to do 
with the RIPscrip code is entirely up to you, the programmer; you can send it 
out a serial port (presumably to a RIPscrip terminal on the other end), save it 
to a disk file or just about anything. 


Every C function in this library is generic. Each function takes parameters 
from your calling application and interprets them, then creates a suitable line 
of RIPscrip code to do what you want it to do. That line of RIPscrip code is 
then returned from the function to your calling program in the form of a 
character buffer. That buffer is maintained directly by the RIP library. 
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1.4 » Examples Using RIP2C Library 


Here is an example much like every programmer's favorite “Hello World” 
program. The necessary things to create the image on the screen are shown 
so that you can get the overall picture. A bit of extra RIPscrip code was 
added to fully set up the environment: 


EXAMPLE: .C: 


#inciude <stdio.h> 
#include “rip.h" 


int main(void) 

{ 
/* Set graphics window */ 
printf("“%s", rip_viewport(0, 0, 639, 300)); 
/* text window from text coords (0,38)-(79,42) */ 
/* Wrap 80-column lines 8x8 pixel text font */ 
printf("%s", rip_text_window(0, 38, 79, 42, 

rTEXT_WRAP, rFONT_8x8)); 


/* Normal drawing mode */ 
printf£("%s", rip_set_write_mode(rMODE_COPY) ); 


/* Set draw color: WHITE */ 
printf£("%s", rip_color(rWHITE) ); 


/* Default Font, Horizontal, Size 1 text (8x8) */ 
printf("%s", rip_font_style(rDEFAULT_FONT, 
YHORIZONTAL, rMAGNIFY_1)); 


/* Place text at (10,10) */ 
printf("ts", rip_text_xy(10, 10, "Hello world")); 


return (0); 


} 


As you can see in the above example code, all of the RIPscrip code generated 
by the program will be output by the standard C output function, printf(). 
Since every RIP C function returns a character pointer, you can do whatever 
you wish with the results. Now you might be thinking to yourself, isn’t that 
a bit cumbersome? What if you had a C file with a thousand rip_XXXXX() 
functions? There is a better solution! 


The RIP library offers several functions that are not part of the RIPscrip 
specification, but are provided in the library to make your life as a 
programmer easier when using the library. The three functions are used to 
customize the output of the RIPscrip functions. The functions allow you to: 
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1) Alter the way RiPscrip code starts. Normally, all RIPscrip commands 
begin with an exclamation mark, Ctr1-A, or Ctr1-B. You can alter 
this if you wish to anything you want, but keep in mind that the !, 
Ctrl-A or Ctr1-B must end the initiator sequence! 


2) Alter the way that RIPscrip code ends. By default, the end of a 
RIPscrip command is a carriage return/line feed (\n). You can 
change this if you wish to whatever sequence you want. 


3) Alter the way the rip_XXXXX() functions handle the final RIPscrip 
code. This means you can set a function pointer to a custom function 
of your own choosing that each rip_XXXXX() function can utilize to 
output your code! This is the method used in the following example. 


Using the 3rd customization option above, here is our example program 
modified slightly to make it easier to code, read, and work with from the 
programmer’s perspective (comments have been deleted for brevity): 


EXAMPLE2.C: 


#include <stdio.h> 
#include "“rip.h" 


void my_output (char *rip_text) 
{ 

printf("%s", rip_text); 
} 


int main(void) 
{ 
set_rip_output_fn(my_output) ; 


rip_viewport(0, 0, 639, 300); 

rip_text_window(0, 38, 79, 42, rTEXT_WRAP, 
rFONT_8x8) ; 

rip_set_write_mode (rMODE_COPY) ; 

rip_color (rWHITE) ; 

rip_font_style(rDEFAULT_FONT, rHORIZONTAL, 
YMAGNIFY_1); 

rip_text_xy(10, 10, “Hello world"); 


return (0); 


) 


Now, instead of having to encase every single rip_XXXXX() function inside 
of a printf() statement, the RIPscrip library will call your my_output() 
function on every rip_XXXXX() function you call, thus outputting the data to 
the standard output device for you automatically. This makes customization 
of output a piece of cake. If you want to dump the RIPscrip code to an output 
file, to a serial port, to the printer or whatever, the choice (and flexibility) is 
up to you. 


Page 4 RIP to C User’s Guide 


rad Ges 


RiP scrip to C Conversion Utility Chapter 2: RIP2C.EXE 


2.0 - RIP2C.EXE — RiPscrip to C Conversion Utility 


RIP2C is the conversion program that converts .RIP files into C 
programming language source code. The source code generated uses the 
RIP2C libraries, which are linked into your C application. The easiest way to 
explain what happens is that when a .RIP file has been converted to C 
source cod and compiled, the program will output the exact same RIPscrip 
code that was converted to C source code. The one minor difference is that 
the program’s output puts one command on each line; the original file 
probably had multiple commands per line. 


How is this useful? Rather than guessing where your RIP output is going to 
be drawn, draw it using RIPaint or RIPdraw, convert it to C source code, and 
copy it into your program’s source code. This makes the tedious work of 
user interface design much easier. 


2.1 * RIP2C.EXE Command Line Parameters 


RIP2C.EXE allows you to specify a number of parameters on the command 
line. The valid command lines parameters are: 


RIP2C [<input filename>] [<output filename>] 


A summary on using RIP2C.EXE can be obtained by typing: RIP2C ?. This 
chapter provides more complete information. 


Both the input and output filename are optional. If no command line 
parameters are specified, RIPscrip commands may be typed directly into the 
converter, and C source code will be output to your screen. You may NOT 
specify wildcards (* or ?) in filenames. A path to the file may be specified if 
desired. 


If only an input file is specified, the C source code is output to the screen. 


MS-DOS file redirection operator (>) can be used here to redirect the output 
to another device (such as a printer) or a file. Refer to your MS-DOS 
documentation for information on the redirection operators. Output can be 
appended to a file by using double-redirection (>>). For example: 

RIP2C MAINMENU.RIP >> PROGRAM.C 


Using just single redirection (>) causes the file to be overwritten. 
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3.0 « RIP2C Library — Support Functions and Macros 


There are several types of routines that make up the RIP2C function library. 
They are divided up into the output routines, Color Palette macros, #defines, 
ANSI sequences, base math routines, and the RIPscrip C function library. 


IMPORTANT 


As stated in the Licensing Agreement, products based on these libraries may 
only be distributed in executable (compiled) form. No source code may be 
distributed, and the library files may not be distributed. If you wish to 
distribute a source code product, you must resell our RIP2C software with it. 
Contact TeleGrafix for information on becoming a reseller. 


IMPORTANT 


3.1 + Output Routines 


There are three basic C functions that are part of the library to allow you to 
customize the way the library operates. In addition, there are a number of 
built-in macro definitions in the RIP .H file to make your life easier when 
working with RIPscrip functions. Each of these are detailed below: 


set_rip_linefeed 

Sets the end-of-line sequence for RIPscrip code lines 

Prototype: void set_rip_linefeed(char *lf_str); 
Parameters: char *lf_str; 


_A pointer to a line-feed terminating string. By default, this 
points to a string containing one line-feed character ("\n"). 


Returns: Nothing 
Note: You are limited to 127 characters for your line-feed sequence. 


This function allows you to customize how the RIP library terminates every 
line of RiPscrip code generated. By default, a line-feed character is output. 
This function is provided so that if you wish to change this to say, a carriage- 
return character ("\r"), or a CR/LF combination ("\r\n") you can. Care 
should be taken when altering the way the end-of-line is handled with 
RiPscrip. RIPscrip commands are very sensitive to starting at the beginning 
of a line, and if the end of a RIPscrip line of code is not terminated properly 
with a line-feed, then the next line of RIPscrip code might be mis-aligned and 
not appear to begin at the start of the next line. 


Example: set_rip_linefeed("\n"); 
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set_rip_ introducer 

Sets the introduction sequence (beginning-of-line) 

Prototype: void set_rip_introducer(char *intro_str) ; 
Parameters: char *intro_str; 


A pointer to a introducer string. By default, this points to a 
string that contains a single exclamation mark ("!"). 


Returns: Nothing 
Note: The introducer sequence is limited to 127 characters. 


This function allows you to alter the way the beginning of a line of RIPscrip 
code starts. By default, RIPscriy commands are formed similar to this: 


!|L00112233 


...where the exclamation mark is the introducer sequence, followed by the 
standard vertical bar delimiter. The introducer sequence can be altered to be 
one of three valid introducers: 


Symbolic constant Description 


rEXCLAMATION Standard RiPscrip introducer ("!") 
rCTRL_A Control-A character (7 \01") 
rCTRL_B Control-B character ("\02") 


If you use the standard introducer, then RIPscrip code MUST begin at the 
start of a text line. If you use the alternative methods of introducing RIPscrip 
code, by using either the Ctr1-A or Ctr1-B introducers, RIPscrip code CAN 
start in the middle of a line. This means you could do something like: 


printf ("Hello world \01]L00112233") ; 
Notice in this example that the Ctr1-A is not at the beginning of a line. 


You are not limited to using just the three introducer sequences. You can if 
you wish alter the introducer to be anything you wish, including carriage 
returns, line-feeds or any other combination of sequences. Great care should 
be taken though to make sure that a valid RIPscrip introducer character is the 
last character of the sequence. 


Example: set_rip_introducer (rEXCLAMATION) ; 
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Output Functions Chapter 3: RIP2C Library 


set_rip output_fn 

Sets a custom output routine for RIPscrip code 

Prototype: void set_rip_output_fn(void (*fn_ptr) (char *)); 
Parameters: void (*fn_ptr) (char *); 


A pointer to a function that is intended to provide 
customized output. By default, this is set to NULL 
indicating no custom output routine is selected. : 


Returns: Nothing 


Note: Your custom function can receive a pointer to a RIPscrip 
buffer containing as much as 4200 bytes of data (this is a 
worst-case scenario with a polygon using all 512 vertices! 


This function is designed so that you can customize the way the RIP C library 
outputs its data. By default, all rip_XXXXX() functions return character 
pointers to a global static character buffer containing the valid RIPscrip code. 
With this function, you can set a custom written routine that will be called 
from any rip_XXXXX() function you use to output that global character 
buffer to your user-supplied functio::. Your function must return a VOID 
and must accept a single parameter, a CHAR *. 


If you wish to disable the custom output, simple call this function with its 
parameter set to NULL, indicating no custom output routine. 


Example: 


void my_output (char *string) 
{ 

printf£("%s", string); 
} 


main (void) 


{ 
set_rip_output_fn(my_output) ; 
) 
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rip_output 
Plain text output via the custom output routines (if any) 
Prototype: char *rip_output(char *string); 


Parameters: char *string 


A pointer to a string that will be output inrouen the custom 
output routine (if any). 


Returns: A character pointer to the output string 


This routine provides the custom output functionality to your program 
without having to directly call the custom output function. You should use 
this function whenever possible instead of directly outputting data through 
your custom defined routine. The reason for this is if our library needs to do 
any custom processing of data or other such stuff, then the low-level routines 
can do that without being bypassed. 


Example: 

void my_output (char *string) 

{ 
printf("%s", string); 

) 

main (void) 

{ 
set_rip_output_fn(my_output) ; 
rip_output ("Hello World\n"); 

} 
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3.2 « Color Palette Macros 


There are also several #define macros available for you to use when 
dealing with custom color palettes. RIPscrip graphics utilizes a custom color | 
palette with 6-bits of precision for its master color palette. This gives you 
two-bits for each RED, GREEN, and BLUE. Due to the evolution of the 
RiPscrip graphical language though, the RGB format is kind of unorthodox. 
With this in mind, we have provided four macros for you to choose from: 


RED_PART (x) Extracts the RED segment from a color value 
GREEN_PART(x) Extracts the GREEN segment from a color value 
BLUE_PART(x) Extracts the BLUE segment from a color value 
RGB2PAL(r,g,b) Creates a master color value from its RED, 
GREEN and BLUE components. 


Predominantly, you will be using the RGB2PAL () macro the most in your 
applications. Let’s say you wanted to set color #3 to a custom RGB setting. 
You could use the following to accomplish this: 


rip_one_palette(3, RGB2PAL(3, 0, 3)); 


This sets color palette entry #3 to an RGB value of RED=3, GREEN=0 and 
BLUE=3. This would result in a bright purple. The valid values for each of 
the RED, GREEN or BLUE are 0, 1, 2 and 3 where 0 is no color in that 
category, and 3 is the maximum color in that category. 


Te 
RIP to C User’s Guide Page 11 


Chapter 3: RIP2C Library #define’s 


3.3 ° #define’s 
MAX POLYPOINTS 


The maximum number of points that a polygon can have. This is currently 
set to 512. You should use this symbolic constant instead of the raw value of 
512 in case future versions of the specifications change this value. 


MAX _X 


The width of the drawing field in pixels. This is currently set to 640, but will 
change in future versions of the RIPscrip specification when other resolutions 
are allowed. 


MAX_Y 


The height of the drawing field in pixels. This is currently set to 350, but will 
change in future versions of the RIPscrip specification when other resolutions 
are allowed. 
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ANSI Sequences Chapter 3: RIP2C Library 
3.4 > ANSI Sequences 


There are three separate ANSI sequences that may be used to control the 
remote terminal (or to ask it something). These commands have been 
provided in function form to generate the appropriate ANSI sequences. 


rip_version 

Prototype: char *rip_version (void) ; 
Parameters: <none> 

Returns: A string pointer to the proper ANSI string 


This command generates the appropriate ANSI sequence to ask the terminal 
what RIPscrip version number it supports. This command is often used to 
“auto-sense” whether a RIPscrip-compatible terminal exists on the remote 
end. If it does, it will return a string similar to the following: 


RIPSCRIP015310 


Vendor's sub-version code 
Vendor Code of software 
Minor RIPscrip version number 
Major RIPscrip version number 
Indicates this is RIPscrip! 


If the terminal on the remote end is not a RIPscrip compatible terminal, then 
this ANSI sequence is ignored. 


The ANSI sequence returned is: ESC [ ! 


Example: printf("%s", rip_version()); 


rip_proc_off 


Prototype: char *rip_proc_off (void) ; 
Parameters: §<none> 
Returns: A string pointer to the proper ANSI string 


This command will generate the ANSI sequence to instruct a RIPscrip 
terminal to stop processing RIPscrip code. This will cause any RIPscrip code 
received to be interpreted as plain text. 


The ANSI sequence returned is: ESC[1! 


Example: printf("*%s", rip_proc_off()); 
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rip_proc_on 


Prototype: char *rip_proc_on(void) ; 
Parameters: <none> 
Returns: A string pointer to the proper ANSI string 


This command will generate the ANSI sequence to instruct the RIPscrip 
terminal to start processing RIPscrip code. This will cause any RIPscrip code 
received to be interpreted as RIPscrip commands and not displayed as text. 


The ANSI sequence returned is: ESC [2! 


Example: printf("%s", rip_proc_on()); 
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Base Math Routines Chapter 3: RIP2C Library 


3.5 » Base Math Routines 


RIPscrip works with base 36 numbers (tri-hexa-decimal, or meganum as we 
call them), instead of the usual base 10 (decimal) or base 16 (hexadecimal). A 
number of conversion routines are provided to allow you to convert various 
C numeric types to a base-36 number in string format. 


C Numeric Type to Meganum conversions: 


mnt 
Convert an integer to meganum 
Prototype: char *mnI(unsigned num, int outlen); 
Parameters: unsigned num ... Number to convert to meganum 
int outlen ... Pad output to this number of characters 
Returns: A character pointer to a string containing the final meganum 


number (null-terminated). 


This function converts an UNSIGNED INT to a meganum string of 
<outlen> characters. The string is null-terminated for you automatically. 


Example: printf£("%s", mnI(40934u, 5)); 
mnL 
Convert a long to meganum 
Prototype: char *mnL(long num, int outlen); 
Parameters: long num ... Number to convert to meganum 
int outlen_ ... Pad output to this number of characters 
Returns: A character pointer to a string containing the meganum 


number (null-terminated). 


This function converts a LONG to a base-36 string of <out len> characters. 
The string is null-terminated for you automatically. 


Example: printf£("%s", mnL(4093434L, 8)); 
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Chapter 3: RIP2C Library Base Math Routines 


mnF 
Convert a float to a meganum 
Prototype: char *mnF(float a_num, int outlen); 
Parameters: float a_num ... Number to convert to meganum 

int outlen__... Pad output to this number of characters 
Returns: A character pointer to a string containing the meganum. 


This function converts a FLOAT (single precision floating point) number to a 
meganum of <outlen> characters. The number is truncated to an even 
decimal number before conversion. The string is null-terminated for you. 


Example: printf("%s", mnF((float)3.14159, 4)); 
mnD 
Convert a double to meganum 
Prototype: char *mnD(double a_num, int outlen); 
Parameters: double a_num ... Number to convert to meganum 

int outlen ... Pad output to this number of characters 
Returns: A character pointer to a string containing the meganum 


number (null-terminated). 


This function converts a DOUBLE (double precision floating point) number 
to a meganum of <out len> characters. The number is truncated to an even 
decimal number before conversion. The return string is null-terminated. 


Example: printf£("%s", mnD((double)3.14159, 4)); 


Meganum to C Numeric Type conversions: 


mtol 

Convert a meganum to an integer 

Prototype: unsigned int mtoI(char *num, int len); 

Parameters: char *num _ ... meganum string to convert to integer 
int len ... Length of string portion to convert 

Returns: An unsigned integer containing the unsigned integer 


number contained in <num> before conversion. 


This function takes a string containing a meganum and converts it to an 
unsigned int. This provides the inverse functionality of mnI. 


Example: unsigned int value; value = mtoI("A359", 4); 
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3.6 « RiPscrip C Function Library 


This section gives semi-detailed information on each RIPscrip C function call 
in the library. Detailed information on each RIPscrip command may be 
found in the RIPscrip Language Reference (Appendix B in the RIPaint User's 
Guide, or the file RIPSCRIP . DOC). The RIPscrip comm::nds appear in the 
same order in this document as they do in the RIPscrip Language Reference. 


The valid parameters for each command are documented including 
associated symbolic constants defined in the header file RIP .H. In the event 
that a parameter is noted as “reserved”, you should use the constant 
rRESERVED instead of the typical “0” parameter. This will insure that 
compatibility will be maintained in future releases of RIP2C. 


Some of the functions listed below use bit flags. Flag parameters can 
combine multiple values together by OR’ing them together to create the final 
composite value. Each of the valid flag values are listed along with the 
parameter’s description. To combine several flags together, use a syntax 
similar to the following: 


FLAG1 | FLAG2 | FLAG3, 
These are the descriptions for each function call: 


rr neers 
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RIP_TEXT_WINDOW 
Function: Define the size and location of the Text Window 
Prototype: char *rip_text_window(int x0, int yO, int xl, 
int yl, int wrap, int size); 
Parameters: int x0 Upper left X coordinate of window 
int y0 Upper left Y coordinate of window 
int xl Lower right X coordinate of window 
int yl Lower right Y coordinate of window 


int wrap Long line handling: 

rTEXT_CHOP (0) Chop lines at the right margin 

rTEXT_WRAP (1) Wrap long lines to the next line 
int size Size of Text Font Cell: 

rFONT_8x8 (0) - 80x43 font 

rFONT_7x8 = (1) - 91x43 font 

rFONT_8x14 (2) - 80x25 font 

rFONT_7x14 (3) -91x25 font 

rFONT_16x14 (4) - 40x25 font 


All X/Y coordinates are specified in text coordinates. Each coordinate is zero 
based and the size of each coordinate is based on the selected font size - in 
other words, the size of each coordinate is not absolute, but relative to 
whatever font cell is specified in the <size> parameter. 


If all parameters are ZERO (0), then the text window is disabled. The lower 
right X/Y coordinates must be greater than or equal to the upper left 
coordinates unless the window is disabled. 


If you wish to disable the text window, you can use the following macro 
defined in RIP.H: 


rip_disable_text_window/() ; 
This evaluates to the command: 

rip_text_window(0,0,0,0,0,0); 
Example: 


rip_text_window(5, 10, 84, 34, rTEXT_WRAP, rFONT_7x8); 
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RIP_VIEWPORT 


Function: Define the size and location of the Graphics Window 
Prototype: char *rip_viewport (int x0, int y0, 
int x1, int yl); 

Parameters: int x0 Upper left X coordinate (0..MAX_X-1) 
int y0 Upper left Y coordinate (0..MAX_Y-1) 
int xl Lower right X coordinate (0..MAX_X-1) 
int yl Lower right Y coordinate (0..MAX_Y-1) 


If all four parameters are ZERO (0), then the graphics viewport is disabled. 
The lower right coordinates must be greater than or equal to the coordinates 
of the upper left corner of the viewport. 


If you wish to disable the graphics viewport, you can use the following 
macro defined in RIP.H: 


rip_disable_ viewport (); 
This evaluates to the command: 
rip_viewport (0,0,0,0); 
Example: 
rip_viewport (0, 0, MAX_X-1, MAX_Y-1); 


RIP_RESET_WINDOWS 

Function: Clear Graphics and Text Windows and resets to full screen 
Prototype: char *rip_reset_windows (void) ; 

Parameters: | <none> 


This deletes all mouse/button fields, clears the screen, makes the text and 
graphics windows full screen, resets the color palette and the fill, border, and 
drawing colors to their default settings, and erases the clipboard. 


Example: 


rip_reset_windows() ; 


RIP_ERASE_ WINDOW 


Function: Clear Text Window to the background color & home cursor 
Prototype: char *rip_erase_window(void) ; 

é Parameters: <none> 
Example: 


rip_erase_window(); 


ee 
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Chapter 3: RIP2C Library RIP scrip C Function Library 


RIP_ERASE_VIEW 


Function: Clear Graphics Window to the background color 
Prototype: char *rip_erase_view(void) ; 

Parameters: § <none> 

Example: 


rip_erase_view() ; 


RIP_GOTOXY 

Function: Moves the text cursor to row & column in Text Window 

Prototype: char *rip_gotoxy(int x1, int yl); 

Parameters: int xl X text coord. to move cursor to (0-91) 
int yl Y text coord. to move cursor to (0-42) 


The location of the cursor in this command is specified in text coordinates 
which are based on the current text window font size. 


Example: 


rip_gotoxy(10, 10); 


RIP_HOME 

Function: Move cursor to upper-left corner of Text Window 
Prototype: char *rip_home (void) ; 

Parameters: | <none> 

Example: 


rip_home(); 


RIP_ERASE_EOL 


Function: Erase the current text line from the cursor to the end of line 
Prototype: char *rip_erase_eol (void); 

Parameters: <none> 

Example: 


rip_erase_eol(); 
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RIP scrip C Function Library Chapter 3: RIP2C Library 


RIP_COLOR 
Function: Set the Drawing Color for graphics primitives 
Prototype: char *rip_color(int color); 
Parameters: int color 
Sets the drawing color for most graphical primitives. 
You can use raw numbers from 0-15, or you can use the pre- 
defined symbolic constants listed here: 
rBLACK (0) 
rBLUE (1) 
rGREEN (2) 
rCYAN (3) 
rRED (4) 
YMAGENTA (5) 
rBROWN (6) 
YLIGHTGRAY (7) 
rDARKGRAY (8) 
rLIGHTBLUE (9) 
rLIGHTGREEN (10) 
rLIGHTCYAN (11) 
rLIGHTRED (12) 
rLIGHTMAGENTA (13) 
rYELLOW (14) 
YWHITE (15) 
Example: 
rip_color (rLIGHTGREEN) ; 
RIP_SET_PALETTE 


Function: 
Prototype: 


Parameters: 


Set 16-color Active Palette from 64-color Master Palette 


char *rip_set_palette(int cl, int c2, int c3, 
int c4, int c5, int c6, int c7, int c8, 
int c9, int cl0,int cll,int ¢c12,int c13, 
int cl4,int c15,int ¢c16); 


int cl Color value for entry #1 (0-63) 
int«¢2 Color value for entry #2 (0-63) 


int cl16 Color value for entry #16 (0-63) 


If you wish to set colors based on Red, Green and Blue values, you can use 
the RGB2PAL() macro. This takes three parameters, each from 0-3 which 
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represent the amounts of Red, Green and Blue to make up the color. See 
above for more detailed information on RGB2 PAL ( ) 


Example: 


rip_set_palette( RGB2PAL(0,0,0), RGB2PAL(0,0,1), 
RGB2PAL(0,1,2), RGB2PAL(0,0,3), RGB2PAL(0,2,3), 
RGB2PAL(1,3,3), RGB2PAL(2,1,0), RGB2PAL(2,2,2), 
RGB2PAL(1,1,1), RGB2PAL(1,0,0), RGB2PAL(2,0,0), 
RGB2PAL(3,0,0), RGB2PAL(3,1,1), RGB2PAL(3,2,2), 
RGB2PAL(3,2,0), RGB2PAL(3,3,3)); 


RIP_ONE_PALETTE 


Function: Set one Active Palette color from the Master Color Palette 
Prototype: char *rip_one_palette(int color, int value); 
Parameters: int color Palette entry number to set (0-15) 


int value Color value to set entry to (0-63) 


If you wish to set colors based on Red, Green and Blue values, you can use 
the RGB2PAL() macro. This takes three parameters, each from 0-3 which 
represent the amounts of Red, Green and Blue to make up the color. See 
above for more detailed information on RGB2PAL ( ) 


Example: 
rip_one_palette(5, RGB2PAL(0,2,3)); 


RIP_WRITE_MODE 


Function: Set drawing mode for graphics primitives 
Prototype: char *rip_write_mode(int mode) ; 
Parameters: int mode Drawing mode for most graphical 


primitives. The symbolic constants that you 
can use for this setting are: 


rMODE_COPY (0) - Normal Drawing 
XMODE_XOR (1) - Draw in XOR mode 


Example: 
rip_write_mode (rMODE_XOR) ; 
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RIP_MOVE 

Function: Move the drawing position to (X,Y) 

Prototype: char *rip_move (int x, int y); 

Parameters: int x X coordinate to move to (0..MAX_X-1) 
int y Y coordinate to move to (0..MAX_Y-1) 

This command is only used with the RIP_TEXT command (see below). 

Example: 


rip_move(10, 10); 
rip_text ("Hello"); 


RIP_TEXT 
Function: Draw text in current font/size/color at current location 
Prototype: char *rip_text(char *str); 
Parameters: char *str Text string to output (1024 chars max) 
Example: 
rip_font_style(rSMALL_FONT, rHORIZONTAL, rMAGNIFY_4, 
YrRESERVED) ; 


rip_color (rLIGHTGRAY) ; 
rip_text_xy(10, 10, "This text is "); 


rip_color (rYELLOW) ; 
rip_text ("yellow "); 


rip_color (rLIGHTGRAY) ; 
rip_text ("showing text concatenation"); 


RIP_TEXT_XY 


Function: Draw text in current font/size/color at specific location 

Prototype: char *rip_text_xy(int x, int y, char *str); 

Parameters: int x Text’s Upper left X coord. (0..MAX_X-1) 
int y Text’s Upper left Y coord. (0..MAX_Y-1) 
char *str Text string to output (1024 chars maximum) 

Example: 

rip_font_style(rSMALL_FONT, rHORIZONTAL, rMAGNI FY_4, 
YrRESERVED) ; 


rip_color (rLIGHTGRAY) ; 
rip_text_xy(10, 10, “This text is at position (10,10)"); 


ee 
RIP to C User’s Guide Page 23 


_ ne 


RIP_FONT_STYLE 
Function: Select font style, orientation, and size 


Prototype: char *rip_font_style(int font, int direction, 
int size, int res); 

Parameters: int font 
The font style to set. You may choose from the 
following 11 font constants: 


rDEFAULT_FONT (0) 
rTRIPLEX_FONT (1) 
rSMALL_FONT (2) 
rSANS_SERIF_FONT (3) 
rGOTHIC_FONT (4) 
rSCRIPT_FONT (5), Ss 
xSIMPLEX_FONT (6) wo 
rTRIPLEX_SCR_FONT (7)/" 
rCOMPLEX_FONT (8) 
rEUROPEAN_FONT (9) 
rBOLD_FONT (10) 


int direction 
This specifies the direction of the text that will be 
output. There are two directions available and their 


constants are: 
rHORIZONTAL (0) 
rVERTICAL (1) 

int size 

This is the magnification size of the font. The 

magnification factors affect each font differently. 

The following magnification constants are available: 
XMAGNIFY_1 (1) 
YrMAGNIFY_2 (2) 
rMAGNIFY_3 (3) 
‘“YMAGNIFY_4 (4) 
rMAGNIFY_5 (5) 
XYMAGNIFY_6 (6) 
rMAGNIFY_7 (7) 
rMAGNIFY_8 (8) 
XYMAGNIFY_9 (9) 
YrMAGNIFY_10 (10) 

int res This parameter is reserved (set to 0) 
Example: 
rip_font_style(rTRIPLEX_FONT, rHORIZONTAL, rMAGNIFY_2, 
'  YRESERVED) ; 
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RIP scrip C Function Library Chapter 3: RIP2C Library 
RIP_PIXEL 
Function: Draws one pixel using current drawing color 
Prototype: char *rip_pixel(int x, int y); 
Parameters; int x X location of pixel (0..MAX_X-1) 
int y Y location of pixel (0..MAX_Y-1) 
Example: 


rip_color (rYELLOW) ; 
rip_pixel(200, 150); 


RIP_LINE 
Function: Draw a line in the current color and line style/thickness 
Prototype: char *rip_line(int x0, int yO, int x1, int yl); 
Parameters: int x0 X location of line start (0..MAX_X-1) 

int y0 Y location of line start (0..MAX_X-1) 

int xl X location of line end (0..MAX_X-1) 

int yl Y location of line end (0..MAX_X-1) 
Example: 


rip_color (rYELLOw) ; 
rip_line(200, 150, 300, 175); 


RIP_RECTANGLE 


Function: Draw a rectangle in current color and line style/thickness 
Prototype: char *rip_rectangle(int x0, int y0, 
int x1, int yl); 

Parameters: int x0 Upper left X coordinate (0..MAX_X-1) 
int y0 Upper left Y coordinate (0..MAX_X-1) 
int xl Lower right X coordinate (0..MAX_X-1) 
int yl Lower right Y coordinate (0..MAX_X-1) 

Example: 


rip_color (rBLUE) ; 
rip_rectangle(200, 150, 400, 300); 


RID ta £ Hear'e Guida Dana OF 


RIP_BAR 
Function: Draw solid, filled rectangle with fill color and pattern. 
Prototype: char *rip_bar(int x0, int yO, int x1, int yl); 
Parameters: int x0 Upper left X coordinate (0..MAX_X-1) 

int y0 Upper left Y coordinate (0..MAX_X-1) 

int xl Lower right X coordinate (0..MAX_X-1) 

int yl Lower right Y coordinate (0..MAX_X-1) 
Example: 


rip_fill_style(rHEAVY_CROSS_HATCH, rRED) ; 
rip_bar(100, 150, 250, 175); 


RIP_CIRCLE 

Function: Draw a circle in current color and line thickness 

Prototype: char *rip_circle(int x_center, int y_center, 

int radius); 

Parameters: int x_center X center point of circle (0..MAX_X-1) 
int y_center Y center point of circle (0.MAX_X-1) 
int radius Radius of circle (0..MAX_X-1) 

Example: 


rip_color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_THICK) ; 
rip_circle(100, 100, 50); 


RIP_OVAL 
Function: Draw ellipse in current color and line style/thickness 
Prototype: char *rip_oval(int x, int y, int st_ang, 
int end_ang, int x_rad, int y_rad); 
Parameters: int x X center point of ellipse (0..MAX_X-1) 
int y Y center point of ellipse (0..MAX_X-1) 
int st_ang Starting angle of arc (0-360) 
int end_ang Ending angle of arc (0-360) 
int x_rad X radius of arc (0..MAX_X-1) 
int y_rad Y radius of arc (0..MAX_Y-1) 
Example: 


rip_color (rLIGHTMAGENTA) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_NORMAL) ; 
rip_oval(100, 50, 0, 360, 70, 20); 


Page 26 RIP to C User’s Guide 


_————— ee 


RIP scrip C Function Library Chapter 3: RIP2C Library 
rh eae se ee ee ey 


RIP_FILLED_OVAL 
Function: Draw filled ellipse using current fill and drawing color 
Prototype: char *rip_filled_oval(int x_center, 

int y_center, int x_rad, int y_rad); 


Parameters: int x_center X center point of ellipse (0..MAX_X-1) 
int y_center Y center point of ellipse (0..MAX_X-1) 
int x_rad X radius of arc (0..MAX_X-1) 
int y_rad Y radius of arc (0..MAX_Y-1) 


Example: 


rip_color (rLIGHTGREEN) ; 
rip_fill_style(rHEAVY_LIGHT_SLASH, rBROWN) ; 
rip_filled_oval(150, 150, 80, 70); 


RIP_ARC 
Function: Draw circular arc in current color and line thickness 
Prototype: char *rip_arc(int x, int y, int st_ang, 
int end_ang, int radius); 
Parameters: int x X center point of circle (0..MAX_X-1) 
int y Y center point of circle (0..MAX_X-1) 
int st_ang Startingangleofarc (0-360) 
int end_ang Ending angleofarc (0-360) 
int radius Radius of arc (0..MAX_X-1) 
Example: 


rip_color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_THICK); 
rip_arc(100, 100, 270, 360, 50); 
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RIP_OVAL_ARC 


Function: Draw an elliptical arc 
Prototype: char *rip_oval_arc(int x, int y, int st_ang, 
int end_ang, int x_rad, int y_rad); 
Parameters: int x X center point of ellipse (0..MAX_X-1) 
int y Y center point of ellipse (0..MAX_X-1) 
int st_ang Starting angle of arc (0-360) 
int end_ang Ending angle of arc (0-360) 
int x_rad Xradiusofarc (0..MAX_X-1) 
int y_rad  /Yradiusofarc (0..MAX_Y-1) 
Example: 


rip_color(rWHITE) ; 
rip_line_style(rNORMAL LINE, rNONE, rwWIDTH_NORMAL) ; 
rip_oval_arc(100, 100, 270, 360, 50, 90); 


RIP_PIE_SLICE 


Function: Draw a circular pie slice 
Prototype: char *rip_pie_slice(int x, int y, int st_ang, 
int end_ang, int radius); 
Parameters: int x X center point of circle (0..MAX_X-1) 
int y Y center point of circle (0..MAX_X-1) 


int st_ang Startingangleofslice (0-360) 
int end_ang Ending angle of slice (0-360) 
int radius Radius of slice (0..MAX_X-1) 


Example: 


rip.color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_THICK) ; 
rip_fill_style(rHEAVY_LIGHT_SLASH, rBROWN) ; 
rip_pie_slice(100, 100, 270, 360, 50); 
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RIP_OVAL_PIE_SLICE 
Function: Draw an elliptical pie slice 


Prototype: char *rip_oval_pie_slice(int x, int y, 
int st_ang, int end_ang, 
int x_rad, int y_rad); 


Parameters: . int x X center point of ellipse (0..MAX_X-1) 
int y Y center point of ellipse (0..MAX_X-1) 
int st_ang Starting angle of slice (0-360) 
int end_ang Ending angle of slice (0-360) 
int x_rad Xradiusof slice (0..MAX_X-1) 
int y_rad  Y radius of slice (0..MAX_Y-1) 
Example: 


rip_color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_THICK) ; 
rip_fill_style(rHEAVY_LIGHT_SLASH, rBROWN) ; 
rip_pie_slice(100, 100, 270, 360, 50, 80); 


RIP_BEZIER 

Function: Draw a bezier curve 

Prototype: char *rip_bezier(int xl, int yl, 

int x2, int y2, int x3, int y3, 
int x4, int y4, int cnt); 

Parameters: int x1 X coord. of Base-Point (0..MAX_X-1) 
int yl Y coord. of Base-Point (0..MAX_Y-1) 
int x2 X coord. of Adj. Point 1 (0..MAX_X-1) 
int y2 Y coord. of Adj. Point 1 (0..MAX_Y-1) 
int x3 X coord. of Adj. Point 2 (0.MAX_X-1) 
int y3 Y coord. of Adj. Point 2 (0..MAX_Y-1) 
int x4 X coord. of End-Point (0..MAX_X-1) 
int y4 Y coord. of End-Point (0..MAX_Y-1) 
int cnt Number of line segments for drawing curve 

Example: 


rip_color (rLIGHTMAGENTA) ; 
rip_line_style(rDOTTED_LINE, rNONE, rWIDTH_NORMAL) ; 
rip_bezier(10, 150, 200, 30, 400, 300, MAX_X-1, 200, 20); 
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RIP_POLYPOINTS 


Function: Set the number of points for a polygon/polyline sequence 
Prototype: int rip_polypoints(int npoints); 

Parameters: int npoints Number of Vertices (2. MAX_POLYPOINTS) 
Note: This is not a RIPscrip command, it is a support function 


This function specifies how many points are going to be used in a particular 
polygon/polyline command. These kinds of commands require two or more 
function calls to get the RIPscrip code completed. For example, to draw a 
polygon with five vertices, you would use code similar to the following: 


Example: 


rip_polypoints (5); 


rip_polygon(10, 10); /* Polygon incomplete */ 
rip_polygon(300, 10); /* Polygon incomplete * / 
rip_polygon(400, 200); /* Polygon incomplete */ 


rip_polygon(200, 300); /* Polygon incomplete “y 
rip_polygon(100, 100); /* Complete - 5th vertex */ 


RIP_POLYGON 


Function: Draw a polygon in current color, line style, and thickness 

Prototype: char *rip_polygon(int x, int y); 

Parameters: int x X coord. of current vertex (0..MAX_X-1) 
int y Y coord. of current vertex (0..MAX_Y-1) 


This function adds an X/Y vertex to the polygon object currently being 
constructed. These kinds of commands require two or more function calls to 
get the RIPscrip code completed. For example, to draw a polygon with five 
vertices, you would use code similar to the following: 


Example: 


rip_color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, rNONE, xrWIDTH_NORMAL) ; 


rip_polypoints (5); 


rip_polygon(10, 10); /* Polygon incomplete */ 
rip_polygon(300, 10); /* Polygon incomplete */ 
rip_polygon(400, 200); /* Polygon incomplete “7 
rip_polygon(200, 300); /* Polygon incomplete ai 


rip_polygon(100, 100); /* Complete - Sth vertex! */ 
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RIP_FILL_POLY 


Function: Draw filled polygon using drawing color and fill settings 
Prototype: char *rip_fill_poly(int x, int y); 
Parameters: int x X coord. of current vertex (0..MAX_X-1) 


int y Y coord. of current vertex (0..MAX_Y-1) 


This function adds an X/Y vertex to the filled polygon object currently being 
constructed. These kinds of commands require two or more function calls to 
get the RIPscrip code completed. For example, to draw a filled polygon with 
five vertices, you would use code similar to the following: 


Example: 


rip_color (rLIGHTBLUBE) ; 
rip_line_style(rNORMAL_LINE, rNONE, rWIDTH_NORMAL) ; 
rip_fill_style(rHEAVY_LIGHT_SLASH, rBROWN); 


rip_polypoints (5); 


rip_fill_poly(10, 10); /* Incomplete */ 
rip_fill_poly(300, 10); /* Incomplete */ 
rip_fill_poly (400, 200); /* Incomplete */ 
rip_fill_poly(200, 300); /* Incomplete */ 
rip_fill_poly(100, 100); /* Complete - Sth vertex! */ 


RIP_POLYLINE 
Function: Draw a Poly-Line (multi-segmented line) 


Prototype: char *rip_polyline(int x, int y); 
Parameters: int x X coord. of current vertex (0..MAX_X-1) 
int y Y coord. of current vertex (0..MAX_Y-1) 


This function adds an X/Y vertex to a poly-line object currently being 
constructed. These kinds of commands require two or more function calls to 
get the RIPscrip code completed. For example, to draw a poly-line with five 
vertices, you would use code similar to the following: 


Example: 


rip_color (rLIGHTBLUE) ; 
rip_line_style(rNORMAL_LINE, YrNONE, rWIDTH_NORMAL) ; 


rip_polypoints (5); 


rip_polyline(10, 10); /* incomplete */ 
rip_polyline(300, 10); /* incomplete */ 
rip_polyline(400, 200); /* incomplete */ 
rip_polyline(200, 300); /* incomplete */ 
rip_polyline(100, 100); /* complete - 5th vertex! */ 
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RIP_FILL 
Function: Flood fill an area of the screen with current fill settings 
Prototype: char *rip_fill(int x, int y, int border); 
Parameters: int x X coord. of fill point — (0..MAX_X-1) 
int y Y coord. of fill point — (0..MAX_Y-1) 
int border Color of Fill Border. You can use a number 
from 0-15, or these symbolic constants: 
rBLACK (0) 
rBLUE (1) 
rGREEN (2) 
rCYAN (3) 
rRED (4) 
rMAGENTA (5) 
rBROWN (6) 
rLIGHTGRAY (7) 
rDARKGRAY (8) 
rLIGHTBLUE (9) 
rLIGHTGREEN (10) 
rLIGHTCYAN (11) 
rLIGHTRED (12) 
rLIGHTMAGENTA (13) 
rYELLOW (14) 
rWHITE (15) 
Example: 


rip_color (rYELLOW) ; 
rip_rectangle(100, 100, 400, 200); 


rip_fill_style(rHEAVY_LIGHT_SLASH, rBLUE) ; 
rip_fil1l(200, 150); 
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RIP_LINE_STYLE 
Function: Defines a line style and thickness 


Prototype: char *rip_line_style(int style, 
unsigned user_pat, int thick); 
Parameters: int style 


A pre-defined line style, unless there is a custom- 
defined pattern. These constants are available: 


xNORMAL_LINE (0) 
rDOTTED_LINE (1) 
rCENTERED_LINE (2) 
YrDASHED_LINE (3) 
rCUSTOM_PATTERN_LINE (4) 


unsigned user_pat 


If the <style> is set to a custom setting, then this 
parameter is the 16-bit pixel pattern for the line. If 
there is no custom pattern, this should be set to 0 
(or 0x0000). 


int thick 
This is the thickness of the line pattern. You can 
choose from one of these constants: 


xWIDTH_NORMAL (1) - 1 pixel wide 
rWIDTH_THICK (3) - 3 pixels wide 


Example: 


rip_line_style(rCUSTOM_PATTERN_LINE, 0x5555, 
rWIDTH_THICK) ; 
rip_line(0, 0, 100, 100); 
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RIP_FILL_STYLE 
Function: Sets fill style (pre-defined patterns) and fill color 
Prototype: char *rip_fill_style(int pattern, 


Parameters: int pattern 


int color 


Example: 


rip_fill_style(rFILL_HEAVE_CROSS_HATCH, 
rip_bar(0, 


0, 


A pre-defined pattern number. You can choose from 
twelve different pre-defined patterns. You can use 


int color); 


the following constants to select these styles: 


Color of the Fill style. You can use a number from 
0-15, or one of these symbolic constants: 


200, 


rFILL_BACKGROUND 
rFILL_SOLID 

rFILL_LINE 
rFILL_LIGHT_SLASH 
rFILL_NORMAL_SLASH 
rFILL_NORMAL_BACKSLASH 
rFILL_LIGHT_BACKSLASH 
rFILL_LIGHT_HATCH 
rFILL_HEAVY_CROSS_HATCH 
rFILL_INTERLEAVING_LINE 
rFILL_WIDELY_SPACED_DOT 


(0) 
(1) 
(2) 
(3) 
(4) 
(5) 
(6) 
(7) 
(8) 
(9) 
(10) 


rFILL_CLOSELY_SPACED_DOT (11) 


rBLACK (0) 
rBLUE (1) 
rGREEN (2) 
rCYAN (3) 
rRED (4) 
xMAGENTA (5) 
rBROWN (6) 
rLIGHTGRAY (7) 
XDARKGRAY (8) 
rLIGHTBLUE (9) 
rLIGHTGREEN (10) 
rLIGHTCYAN (11) 
rLIGHTRED (12) 
YrLIGHTMAGENTA (13) 
rYELLOW (14) 
rWHITE (15) 


75}3 


rGREEN) ; 
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RIP_FILL_PATTERN 
Function: Sets a user-definable (custom) fill pattern and color 


Prototype: char *rip_fill_pattern(int cl, int e2;, 
int c3, int c4, int cS, int c6, int c7, 
int c8, int color); 


Parameters: int cl 8-pixel pattern for line 0 (0..255) 
int c2 8-pixel pattern for line 1 (0..255) 
int c3 8-pixel pattern for line 2 (0..255) 
int c4 8-pixel pattern for line 3 (0..255) 
int c5 8-pixel pattern for line 4 (0..255) 
int c6 8-pixel pattern for line 5 (0..255) 
int.c7 8-pixel pattern for line 6 (0..255) 
int c8 8-pixel pattern for line 7 (0..255) 


int color Color of the Fill style. You can use a number 
from 0-15, or one of these symbolic constants: 


r BLACK (0) 
rBLUE (1) 
rGREEN (2) 
rCYAN (3) 
rRED (4) 
rMAGENTA (S) 
rBROWN (6) 
rLIGHTGRAY (7) 
rDARKGRAY (8) 
rLIGHTBLUE (9) 
rLIGHTGREEN (10) 
rLIGHTCYAN (11) 
rLIGHTRED (12) 
rLIGHTMAGENTA (13) 
rYELLOW (14) 
rWHITE (15) 


Example: 


rip_fill_pattern(OxFF, OxAA, 0x55, 0x33, OxFF, OxAA, 
0x55, 0x33, rBROWN) ; 
rip_bar(0, 0, 500, 150); 
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RIP_MOUSE 
Function: Defines a rectangular hot mouse region 
Prototype: char *rip_mouse(int num, int x0, int y0, 
int xl, int yl, int clk, int clr, 
int res, char *text); 
Parameters: int num A reserved parameter (set to 0) 
int x0 Upper left X of region (0..MAX_X-1) 
int y0 Upper left Y of region (0..MAX_Y-1) 
int x1 Upper left X of region (0..MAX_X-1) 
int yl Upper left Y of region (0..MAX_Y-1) 
int elk Set this to 1 if the area should be inverted 
while clicked. If 0, then the area won’t be inverted. 
You can use the following constants instead: 
rINVERT_NO (0) - Don’t invert 
rINVERT_YES (1) - Invert region 
int clr Set this to 1 if the screen should be reset 
after click, or 0 if it should be left alone. You can use 
the following constants instead: 
rRESET_NO  (0)- Don’t reset screen 
YrRESET_YES (1) - Reset screen 
int res This parameter is reserved (set to 0) 


char *text Pointer to a text string to use as the host 
command. Maximum length: 1024 bytes 


Example: 
rip_mouse(rNONE, 50, 50, 150, 75, rINVERT_YES, 
rRESET_YES, rRESERVED, "This is a host command*M") ; 


RIP_KILL_MOUSE_FIELDS 


Function: Destroys all previously defined hot mouse regions 
Prototype: char *rip_kill_mouse_fields (void); 
Parameters: | <none> 

Example: 


rip_kill_mouse_fields(); 


a RR ett it pt Be ea Pd tk ae eae ae ee ee ee ee eee o 


RIP scrip C Function Library Chapter 3: RIP2C Library 
rs I es LIDF OLY 


RIP_BEGIN_TEXT 


Function: Define a rectangular text region 

Prototype: char *rip_begin_text(int xl, int yl, 

int x2, int y2, int res); 

Parameters: int x1 Upper left X of region (0..MAX_X-1) | 
int yl Upper left Y of region (0..MAX_Y-1) | 
int x2 Lower right X of region (0..MAX_X-1) | 
int y2 Lower right Y of region (0..MAX_Y-1) 
int res This parameter is reserved (set to 0) 

Example: 


rip_color (rLIGHTGRAY) ; 
rip_font_style(rSMALL_FONT, YrHORIZONTAL, rMAGNIFY_4, 
YRESERVED) ; 


rip_begin_text(189, 44, 394, 120, rRESERVED); 


rip_region_text(0, "RIP2C Tutorial"); 

rip_region_text(1, " "); 

rip_region_text(1, "This section is designed to walk"); 
rip_region_text(1, “you through the basic features of"); 
rip_region_text(1, "RIP2C, and familiarize you with"); 
rip_region_text(0, “programming in RIPscrip from C."); 


rip_end_text(); 


RIP_REGION_TEXT 
Function: Display a line of text in rectangular text region 


Prototype: char *rip_region_text(int justify, 
char *text) ; 
Parameters: int justify This mode parameter determines if 


full left/right justification should be performed on 
the given text line. You can use these constants: 


rJUSTIFY_LEFT (0) - Left Just. Only 
rJUSTIFY_RIGHT (1) - Full Justify 


char *text Character pointer to string to output on this 
line of the text region. 


Example: See example under RIP_BEGIN_TEXT above. 
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RIP_END_TEXT 

Function: End a rectangular text region 
Prototype: char *rip_end_text (void); 
Parameters: <none> 


Example: See example under RIP_BEGIN_TEXT above. 


RIP_GET_IMAGE 


Function: Copy rectangular screen image to the clipboard (as an icon) 
Prototype: char *rip_get_image(int x0, int y0, 
int xl, int yl, int res); 

Parameters: int x0 Upper left X of image (0..MAX_X-1) 

int y0 _ Upper left Yofimage (0..MAX_Y-1) 

int xl Lower right X of image (0..MAX_X-1) 

int yl Lower right Y of image (0..MAX_Y-1) 

int res This parameter is reserved (set to 0) 


The lower right X/Y corner of the image area MUST be greater than or equal 
to the upper left corner’s coordinate. 


Example: 
rip_get_image(100, 100, 150, 125, rRESERVED) ; 
rip_put_image(200, 100, rMODE_COPY, rRESERVED) ; 
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RIP_PUT_IMAGE 


Function: Pastes the clipboard (icon) contents onto the screen 
Prototype: char *rip_put_image(int x, int y, int mode, 
int res); 
Parameters: int x Upper left X of image (0..MAX_X-1) 
int y Upper left Y of image (0..MAX_Y-1) 
int mode This is the mode in which the image is 


pasted to the screen. You can choose from the 
following symbolic constants for paste modes: 


YMODE_COPY (0) - Paste normally 
YMODE_XOR (1) - Exclusive-OR 
rMODE_OR (2) - Logical OR 
rMODE_AND (3) - Logical AND 
rMODE_NOT (4)- Paste inverse 


int res This parameter is reserved (set to 0) 


Example: 
rip_get_image(100, 100, 150, 125, rRESERVED) ; 


rip_put_image(200, 100, xrMODE_COPY, rRESERVED); 
rip_put_image(100, 150, xrMODE_COPY, rRESERVED) ; 
rip_put_image(200, 150, xrMODE_COPY, rRESERVED) ; 


RIP_WRITE_ICON 


Function: Write contents of the clipboard (icon) to disk 
Prototype: char *rip_write_icon(int res, 
char *filename) ; 
Parameters: int res This parameter is reserved (set to 0) 
char *filename String pointer to a filename to store 


the clipboard to. No path info is allowed. The .ICN 
extension is optional and is appended if omitted. 


Example: 
rip_get_image(100, 100, 150, 125, rRESERVED) ; 
rip_write_icon(rRESERVED, "“SAVED.ICN"); 
rip_reset_windows(); /* Erase screen & clipboard */ 


rip_load_icon(100, 100, rMODE_COPY, rICON_PASTEONLY, 
YrRESERVED, "SAVED.ICN") ; 
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RIP_LOAD_ICON 


Function: Loads and displays a disk-based icon to screen 
Prototype: char *rip_load_icon(int x, int y, int mode, 
int clipboard, int res, char *filename); 
Parameters: int x Upper left X of image (0..MAX_X-1) 
int y Upper left Y of image (0..MAX_Y-1) 
int mode This is the mode in which the image is 


pasted to the screen. You can choose from the 
following symbolic constants for paste modes: 


rMODE_COPY (0) - Paste normally 
YMODE_XOR (1) - Exclusive-OR 
rMODE_OR (2) - Logical OR 
rMODE_AND (3) - Logical AND 
rMODE_NOT (4) - Paste inverse 


int clipboard If 1, then the image is also loaded 
onto the clipboard. Use the following constants: 


rICON_PASTEONLY (0) - Paste only 
rICON_PASTECLIP (1) - Put on Clipboard 


int res This parameter is reserved (set to 0) 

char *filename String pointer to a filename to store 
the clipboard to. No path info is 
allowed. The .ICN extension is 
optional and is appended if omitted. 


Example: 


rip_load_icon(0, 0, rMODE_XOR, rICON_PASTECLIP, 
YrRESERVED, "“WORLD-1.ICN"); 
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RIP_BUTTON_STYLE 
Function: Button Style Definition 


Prototype: char *rip_button_style(int wid, int hgt, 
int orient, int flags, int size, 

) int dfore, int dback, int bright, 
int dark, int surface, int grp_no, 
int flags2, int uline_col, 
int corner_col, int res); 

Parameters: int wid Fixed-Width of button (0..MAX_X-1) 
int hgt Fixed-Height of button (0..MAX_Y-1) 
int orient Orientation of button label (if any). 

You can choose from these constants: 


rLABEL_ABOVE (0) - Above button 
YLABEL_LEFT (1) - Left of button 
rLABEL_CENTER (2) - In button Center 
rLABEL_RIGHT (3) - Right of Button 
rLABEL_BELOW (4) - Below Button 


int flags Various mode flags for buttons. These 
options can be OR’! ‘ogether to get many flag 
combinations. The 4 -ailable flags are as follows: 


rSTYLE_CLIPBOARD (1) 
Button is a clipboard button 
rSTYLE_INVERTABLE (2) 
Button is invertable 
rSTYLE_RESET (4) 
Reset screen after button click 
rSTYLE_CHISEL (8) 
Display chisel special effect 
rSTYLE_RECESSED (16) 
Display recessed special effect 
rSTYLE_DROPSHADOW (32) 
Dropshadow the label (if any) 
rSTYLE_IMAGE_TO_CLIP (64) 
Auto-stamp image onto clipboard 
rSTYLE_ICON (128) 
Button is an Icon Button 
rSTYLE_PLAIN (256) 
Button is a Plain Button 
rSTYLE_BEVEL (512) 
Display Bevel special effect 
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rSTYLE_MOUSE (1024) 
Button is a Mouse Button 

xrSTYLE_UNDERLINE | (2048) 
Underline the hot-key in label 

rSTYLE_HOT_ICON (4096) 
Make Icon Button use Hot Icons 

rSTYLE_ADJ_VERTICAL (8192) 
Adj vertical centering of label 

rSTYLE_RADIO_GROUP (16384) 
Button belongs to a Radio Group 

rSTYLE_SUNKEN (32768) 
Display Sunken special effect 


int size Size of Bevel (0 if none) 
int dfore Foreground color of label 

(see RIP_COLOR for symbolic constants) 
int dback Background color of label if any 

(see RIP_COLOR for symbolic constants) 
int bright Bright effects color for button 

(see RIP_COLOR for symbolic constants) 
int dark Dark effects color for button 

(see RIP_COLOR for symbolic constants) 
int surface Surface effects color for button 

(see RIP_COLOR for symbolic constants) 
int grp_no Button Group Number (0-35) 
int flags2 More mode flags. These can also be OR’d 

together. Choose from these constants: 


rSTYLE_CHECKBOX_GROUP (1) 
Button is in a Checkbox Group 
rSTYLE_HILIGHT_HOTKEY (2) 
Highlight Hotkey character 
rSTYLE_EXPLODE (4) 
Explode (Zoom Out when clicked) 
rSTYLE_LEFT_JUSTIFY (8) 
Left just label (top/center /bottom) 
rSTYLE_RIGHT_JUSTIFY (16) 
Right just label (top/center /bottom) 
int uline_col Underline /Hotkey color for button 
(see RIP_COLOR for constants) 
int corner_col Corner effects color for button 
(see RIP_COLOR for constants) 
int res This parameter is reserved (set to 0) 
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See the RIPscrip Language Reference for a detailed explanation of this 
command, its flag combinations and what everything does (in detail). 


Example: 
rip_button_style ( 
0, /* 
0, /* 
rLABEL_CENTER, /* 


YrSTYLE_INVERTABLE | 
rSTYLE_MOUSE | 
rSTYLE_DROPSHADOW | 
rSTYLE_PLAIN 1 
rSTYLE_BEVEL | 
rSTYLE_MOUSE | 
rSTYLE_UNDERLINE | 
rSTYLE_SUNKEN, 


1, i 
rYELLOW, /* 
rBLACK, /* 
rWHITE, dos 
xDARKGRAY, /* 
rLIGHTGRAY, /* 
0, gs 
rSTYLE_HILIGHT_HOTKEY, /* 
rBLACK, /* 
rLIGHTGRAY, /* 
YrRESERVED) ; /* 


rip_button(104, 224, 234, 236, 


“<>Users Online<>/#°M") ; 
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Width */ 
Height */ 
Label Orientation */ 
Flags */ 


Bevel Size */ 

Label Fore color */ 
Label shadow color */ 
Bright color */ 
Dark color */ 

Surface color */ 
Group Number */ 
Flags 2 */ 

Underline color/hotkey */ 
Corner color */ 
Reserved parameter */ 


85, rNONE, rRESERVED, 
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RIP_BUTTON 
Function: Draw a button 
Prototype: char *rip_button(int x0, int y0, 
int x1, int yl, int hotkey, int flags, 
int res, char *text); 
Parameters: int x0 Upper left X of button (0..MAX_X-1) 
int y0 Upper left Y of button (0..MAX_Y-1) 
int x1 Lower right X of button (0.MAX_X-1) 
int yl Lower right Y of button (0.MAX_Y-1) 


int hotkey Hotkey ASCII value (0..255) 
Values: 0=none, 255=any-key 

int flags OR’able mode flags for button. 
The available constants are: 


rBTN_SELECTED (1) - Button is drawn selected 
rBTN_DEFAULT (2) - Button is a default Button 


int res This parameter is reserved (set to 0) 
char *text String pointer containing the button’s label, 
host command and icon filename (if any). 


See the RIPscrip Language Reference for a detailed explanation of this 
command. There are a number of things which can affect a button’s 
appearance and operation. Pay close attention to the format of the <text> 
parameter, as there are three segments to it and must be present for things to 
work properly. 


Example: See RIP_BUTTON_STYLE for an the example 
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RIP_DEFINE 
Function: Define a text variable 


Prototype: char *rip_define(int flags, int res, 
char *text); 

Parameters: int flags These are OR’able mode flags which 
indicate the operation of the define statement. 


The following constants apply: 
rDEFINE_SAVE (1) 
Save to database 
rDEFINE_FORCE_ANSWER (2) 
No blank responses 
rDEFINE_NOT_INTERACTIVE (4) 
Non-interactive query 
int res This parameter is reserved (set to 0) 
char *text Pointer to string containing the define 
expression. 


See the RIPscrip Language Reference for a detailed explanation of the format 
of the <text> parameter containing the define expression. 


Example: 


rip_define (rDEFINE_SAVE|rDEFINE_FORCE_ANSWER, rRESERVED , 
“FULL_NAME,30:?Whats is your full name?John Doe"); 
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RIP_QUERY 
Function: Query the content of a text variable 
Prototype: char *rip_query(int mode, int res, char *text); 
Parameters: int mode This parameter determines the mode of the 
query command. You may choose from the 
following three modes: 
rQUERY_NOW (0) 
Process Query NOW 
rQUERY_GRAPHICS (1) 
Process with Graphics Click 
rQUERY_TEXT (2) 
Process with Text Window Click 
int res This parameter is reserved (set to 0) 


char *text String pointer to query expression 


Consult the RIPscrip Language Reference for detailed information about 
what can be done with this command including text variables, pop-up pick 
lists, and much more. This command is often the heart of the RIPscrip text 
variable programming language and offers a great deal of flexibility! 


Example: 
rip_query (rQUERY_NOW, rRESERVED, 
“The date/time is $DATE STIMES“m"); 


RIP_COPY_REGION 


Function: Copy screen region up/down 
Prototype: char *rip_copy_region(int x0, int y0, int xl, 
int yl, int res, int dest_line); 

Parameters: int x0 Upper left Xofregion (0..MAX_X-1) 
int yO Upper left Yofregion (0..MAX_Y-1) 
int x1 Lower right X of region (0..MAX_X-1) 
int yl Lower right Y of region (0..MAX_Y-1) 
int res This parameter is reserved (set to 0) 


int dest_line Destination Yofregion (0..MAX_Y-1) 
Example: 
rip_copy_region(100, 100, 300, 200, rRESERVED, 50); 
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RIP_READ_SCENE 


Function: Playback local .RIP file 

Prototype: char *rip_read_scene(int res, char *filename); 

Parameters: int res This parameter is reserved (set to 0) 
char *filename String pointer to the filename of the 


-RIP file to be played back. If the .RIP extension is 
omitted, it is appended automatically. 


Example: 
rip_read_scene(rRESERVED, "“MAINMENU.RIP"); 


RIP_FILE_QUERY 
Function: Query existing information on a particular file 


Prototype: char *rip_file_query(int mode, int res, 
char *filename) ; 


Parameters: int mode File Query mode. You may choose from the 
following symbolic constants: 


rFILE_NORMAL (0) 
EXISTS = "0" or"1" 
rFILE_CR (1) 
EXISTS = "O<cr>"or “l<cr>" 
rFILE_SIZE (2) 
EXISTS .SIZE<CR> 
rFILE_EXTENDED (3) 
EXISTS .SIZE.DATE.TIME<CR> 
rFILE_EXTFILENAME (4) 
EXISTS. FILE.SIZE.DATE.TIME<CR> 


int res This parameter is reserved (set to 0) 
char *filename String pointer to the filename to be 
queried 


Example: 
rip_file_query (rFILE_EXTENDED, rRESERVED, "“EMAIL.ICN"); 
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RIP_ENTER_BLOCK_MODE 
Function: Enter block transfer mode with host 


Prototype: char *rip_enter_block_mode(int mode, 
int proto, int filetype, int reserved, 
char *filename) ; 
Parameters: int mode Block transfer direction mode. You may 
choose from the following constants: 


40 sTfens Lom bees YBLOCK_DOWNLOAD (0) - Download block mode 
Frove thent 49 Wos+ BLOCK _UPLOAD (1) - Upload block mode 


int proto The file transfer protocol that should be 
used for the transfer. You can choose from the 
following symbolic constants: 


rPROT_XMODEM (0) 

Block Mode: Xmodem (checksum) 
rPROT_XMODEM_CRC (1) 

Block Mode: Xmodem-CRC 
xrPROT_XMODEM_1K (2) 

Block Mode: Xmodem-1K 
rPROT_XMODEM_1K_G (3) 

Block Mode: Xmodem-1K (G) 
xrPROT_KERMIT (4) 

Block Mode: Kermit 
rPROT_YMODEM (5) 

Block Mode: Ymodem (batch) 
xPROT_YMODEM_G (6) 

Block Mode: Ymodem (G) 
rPROT_ZMODEM (7) 

Block Mode: Zmodem 


int filetype This option determines what type of 
file is to be expected and what to do with the file 
when received. These constants are available: 


For Upload mode: 
rBLOCK_NOMODE (0) 
For upload, mode is ignored 


For Download mode: 
rBLOCK_RIP_SHOW (0) 
Receive RIP file and show 
rBLOCK_RIP_STORE (1) 
Receive RIP file - store only 
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rBLOCK_ICON (2) 
Receive ICN file - store only 
xBLOCK_HELP_FILE (3) 
Receive HLP file (obsolete) 
rBLOCK_DYNAMIC_NOSHOW (4) 
Receive files - store only 
xBLOCK_DYNAMIC_SHOW (5) 
Receive files - show if possible 
int reserved This parameter is reserved (set to 0) 
char *filename String pointer to the filename(s) for 


the transfer. This string must end in a "<>" even if 
no filename is present. 


See the RIPscrip Language Reference for a more detailed explanation of this 
command. 


Example: 


rip_enter_block_mode (rDOWNLOAD, 
rPROT_XMODEM_1K, 
rBLOCK_DYNAMIC_SHOW, 
YrRESERVED, 
“MAINMENU.RIP<>"); 


RIP_NO_MORE 

Function: End of RIPscrip scene 
Prototype: char *rip_no_more (void); 
Parameters: <none> 

Example: 


rip_color (rYELLOWw) ; 
rip_line(0, 0, MAX_X-1, MAX_Y-1); 


rip_no_more(); 
rip_no_more(); 
rip_no_more(); 
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3.7 » RIP scrip Text Variable C Library 


Because RIPscrip contains a large number of built-in text variable commands 
that can be used for different purposes, the RIPscrip C library offers you easy 
access to them with function-like programming statements. 


There are three types of Text Variables. 


¢ Built-In Text Variables that RIPscrip products will ALWAYS know 
about. These include Text Variables like date and time that return a 
value. Also known as Data Variables. 


¢ Another type of built-in Text Variable are Active Text Variables, 
which perform an action, but return nothing to the host. These 
include turning the status bar on/off, clearing the graphics screen, 
and playing some simple sounds. 


¢ Then there are also User Text Variables that can contain a variety of 
information depending on what the user entered at the time the 
variable was created. For example, the host might ask you what the 
contents of the $FULL_NAMES variable is, and if RIPterm doesn’t 
know, it could pop-up a field on the screen and ask you about it. 
From then on, RiPterm will remember that piece of information for 
the next time it is needed by a host. 


Each text variable in the RIPscrip language can be accessed by a single 
function call. The active variables are listed first, followed by the data- 
variables. Each one of these functions is a #define located in the header file 
RIP.H. They are made into macros for code-smalliness and for simplicity. 
Each of these macros evaluate to a call similar to the following (for the 
$ADOWS$ variable): 


query_abbr_dow () 
is defined as to: 
rip_query (rQUERY_NOW, rRESERVED, “\SADOW\$") 


Se 
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Active Text Variables 


rip_sound_alarm() 
rip_run_app0 () 
rip_run_app1() 
rip_run_app2 () 
rip_run_app3 () 
rip_run_app4 () 
rip_run_app5() 
rip_run_app6 () 
rip_run_app7 () 
rip_run_app8 () 
rip_run_app9 () 
rip_sound_beep() 
rip_sound_blip() 
rip_cursor_off() 
rip_cursor_on() 
rip_disable_twin() 
rip_doorway_off () 
rip_doorway_on() 
rip_erase_gwin() 
rip_erase_twin() 
rip_hotkeys_off () 
rip_hotkeys_on() 
rip_kill_fields() 
rip_sound_music() 
rip_paste_clip() 
rip_restore_clip() 
rip_sound_phaser () 
rip_reset () 
rip_restore_scrn() 
rip_restore_scrn0() 
rip_restore_scrn1() 
rip_restore_scrn2() 
rip_restore_scrn3() 
rip_restore_scrn4() 
rip_restore_scrn5() 
rip_restore_scrn6() 
rip_restore_scrn7 () 
rip_restore_scrn8 () 
rip_restore_scrn9() 
rip_restore_all() 
rip_sound_rphaser () 


$ALARMS$ - Generate an Alarm Sound 
$APP0§ - Run Application #0 

$APP1$ - Run Application #1 

$APP2§ - Run Application #2 

$APP3§ - Run Application #3 

$APP4$ - Run Application #4 

$APP5$ - Run Application #5 

$APP6$ - Run Application #6 

$APP7$ - Run Application #7 
$APP8$ - Run Application #8 

$APP9$ - Run Application #9 

$BEEP$ - Generate a Beep Sound (ala Ct r1-c) 
$BLIP$ - Generate a Blipping Sound 
$COFF$ - Turn OFF cursor 

$CON$ - Turn ON cursor 

$DTWS$ - Disable Text Window 
$DWAYOFF$ - Doorway Mode OFF 
$DWAYONS$ - Doorway Mode ON 
$EGWS - Erase Graphics Window 
$ETW$ - Erase Text Window 
$HKEYOFF$ - Button Hotkeys OFF 
$HKEYON$ - Button Hotkeys ON 
$MKILLS - Kill all Mouse Fields 
$MUSIC$ - Generate a Musical Sound 


- $PCBS§ - Paste clipboard (to last location clipped) 


$RCB$§ - Restore clipboard from disk file 
$PHASER$ - Phaser Sound 

$RESET$ - Performs a RIP_RESET_ WINDOWS 
$RESTORE$ - Restore Graphics Screen 
$RESTORE0$ - Restore Graphics Screen 0 
$RESTORE]$ - Restore Graphics Screen 1 
$RESTORE2§ - Restore Graphics Screen 2 
$RESTORE3$ - Restore Graphics Screen 3 
$RESTORE4$ - Restore Graphics Screen 4 
$RESTORES$ - Restore Graphics Screen 5 
$RESTORE6$ - Restore Graphics Screen 6 
$RESTORE7$ - Restore Graphics Screen 7 
$RESTORE8$ - Restore Graphics Screen 8 
$RESTORE9$ - Restore Graphics Screen 9 
$RESTOREALL$ - = RESTORE RTW RCB RMF 
$REVPHASERS - Reverse Phaser Sound 


rip_restore_fields() $RMF%$ - Restore Mouse Fields 
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rip_restore_twin() 


rip_save_scrn() 
rip_save_scrn0() 
rip_save_scrnl () 
rip_save_scrn2() 
rip_save_scrn3 () 
rip_save_scrn4() 
rip_save_scrn5() 
rip_save_scrn6() 
rip_save_scrn’7 () 
rip_save_scrn8() 
rip_save_scrn9() 
rip_save_all() 
rip_status_off() 
rip_status_on() 
rip_save_clip() 
rip_save_fields() 
rip_save_twin() 


rip_tab_fields_off () 
rip_tab_fields_on() 


rip_vt102_off() 
rip_vt102_o0n() 


Page 52 


$RTW$§ - Restore Text Window 
$SAVE$ - Save graphics screen 
$SAVEO$ - Save graphics screen 0 
$SAVE1§ - Save graphics screen 1 
$SAVE2$ - Save graphics screen 2 
$SAVE3$ - Save graphics screen 3 
$SAVE4§ - Save graphics screen 4 
$SAVE5§ - Save graphics screen 5 
$SAVE6$ - Save graphics screen 6 
$SAVE7$ - Save graphics screen 7 
SSAVE8$ - Save graphics screen 8 
$SAVE9$ - Save graphics screen 9 
SSAVEALLS - Performs: SAVE SMF SCB STW 
$SBAROFF$ - Turn OFF status bar 
$SBARON$ - Turn ON status bar 
$SCB§ - Save Clipboard 

$SMF$ - Save Mouse Fields 

$STW$ - Save Text Window 
$TABOFF$ - Disable TAB fields 
$TABONS$ - Enable TAB fields 
$VT102OFF$ - VT-102 keystrokes OFF 
$VT102ON$ - VT-102 keystrokes ON 
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Data Variables 


query_abbr_dow() 
query_am_pm() 
query_is_cursor_on() 
query_cursor_x() 
query_cursor_y() 
query_date() 
query_date_time() 
query_day_of_month() 
query_day_of_week () 
query_day_of_year () 
query_4 digit_year() 
query_hour () 
query_mouse_buts () 
query_hour_24 () 
query_minutes () 
query_month_name () 
query_month_num() 
query_mouse_status() 
query_rip_version() 
query_seconds () 
query_status_bar () 
query_time () 
query_timezone() 
query_text_font () 
query_twin_height () 
query_twin_active() 
query_twin_width() 
query_twin_x0 () 
query_twin_x1() 
query_twin_y0 () 
query_twin_yl() 
query_weekday_num() 
query_week_sunday () 
query_week_monday () 
query_mouse_x() 
query_mouse_xy () 
query_full_mouse () 
query_mouse_y () 
query_year () 
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$ADOWS - Abbreviated Day of Week 

$AMPMS$ - Either AM/PM depending on time 
$CURSORS - YES if cursor on, NO otherwise 
$CURX$ - Current Cursor X position 

$CURY$ - Current Cursor Y position 

$DATE$ - Current Date (MM/DD/YY format) 
$DATETIMES - Current Date & Time 

$DAY$ - Current Day (format DD) 

$DOWS - Current Day of week (full length) 
$DOY$ - Current Day of year (001-366) 
$FYEARS$ - 4 digit year (with century) 

$HOURS$ - Hour (format HH) - normal style 
$M$ - Mouse Button Status: LMR (e.g. 101) 
$MHOURS - Hour (format HH) - Military style 
$MIN$ - Minutes (00-59) 

$MONTHS - Current Month Name 
$MONTHNUMS$ - Month (in format 1-12) 
$MSTATS$ - Does terminal system have a mouse? 
$RIPVER$ - RiPscrip version: RIPSCRIP015400 
$SEC$ - Current Seconds (00-59) 

$STATBARS$ - YES if Status Bar on, else NO 
$TIMES - Current Time (in HH:MM:SS format) 
$TIMEZONES - Time Zone or "NONE" if not set 
$TWFONTS - Returns current text font (0-4) 
$TWHS$ - Text Window Height 

$TWINSG - YES if text window active, else NO 
$TWWS - Text Window Width 

$TWXO0$ - UL X of text window 

$TWX1$ - LR X of text window 

$TWY0$ - UL Y of text window 

$TWY1§ - LR Y of text window 

$WDAY$ - Weekday where 0 is Sunday (0-6) 
$WOYS$ - Week of cur year 00-53; Sunday=1st 
$WOYMS$ - Week of cur year 00-53; Monday=ist 
$X$ - Current X Mouse location (format: xxxx) 
$XY$ - Current X/Y Mouse (xxxx:yyyy) 

$XYM$ - X/Y & button status Qooocyyyy:Imr) 
$Y$ - Current Y Mouse (format: yyyy) 

$YEARS$ - 2 digit year (w/o century) (00-99) 
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